home *** CD-ROM | disk | FTP | other *** search
/ Practical Internet 2001 August / Practical Internet August 2001.iso / Acro30 / abcpydoc.ini < prev    next >
INI File  |  2001-10-17  |  15KB  |  317 lines
  1. ;*******************************************************************************
  2. ;
  3. ;ABCPYDOC.INI - This file is an example file that shows how to provide the
  4. ;               "blind-copy" capability for use with Adobe Acrobat installations.
  5. ;
  6. ;NOTE:  Do NOT use this file for blind-copy.  It is meant only as an example.
  7. ;*******************************************************************************
  8. ;
  9. ;Blind-copy capability provides a mechanism where a customer may add to
  10. ;an installation set.  To trigger the blind-copy mechanism, a file named
  11. ;ABCPY.INI (Adobe Blind CoPY initialization file) must exist in the same 
  12. ;directory as the installer (SETUP.EXE) for Acrobat, whether for the individual
  13. ;Acrobat products or the Acrobat 3.0 "umbrella". 
  14. ;
  15. ;ABCPY.INI is formatted similar to an .INI file, with section names that must
  16. ;match values set in ACROINST.INI (a hidden file used by Acrobat installations).
  17. ;For example, if a customer needs the blind-copy capability for an Acrobat Reader
  18. ;installation, a section in ABCPY.INI must be named [ReaderBlindCopy].  If 
  19. ;Acrobat Exchange is the product installed, a section named [ExchangeBlindCopy] 
  20. ;must exist in ABCPY.INI.
  21. ;
  22. ;There are five types of "object actions" that can be added.  1) A "requirement"
  23. ;may be performed, 2) files can be copied, 2) program items or shortcuts 
  24. ;(depending on the target operating system) can be created, 3) registry entries 
  25. ;can be created, and 4) INI entries can be created.
  26. ;
  27. ;To have an action performed on these blind-copy objects, there are several 
  28. ;entries that must be made within the product's blind-copy section.  First,
  29. ;there must be a key named "NumberOfGroups" and this key must have a value
  30. ;of 1 or more.  
  31. ;
  32. ;For each "group", there will need to be entries for operating system platform, 
  33. ;target destination location, source location, and an optional entry for a 
  34. ;"group" name which is used for the group name when program items or shortcuts 
  35. ;are created.  
  36. ;
  37. ;By reviewing the example section in this file, the entries for each group are:
  38. ;Group<X>Platform=All
  39. ;Group<X>DestDir=Org
  40. ;Group<X>Loc=Org
  41. ;Group<X>Name=
  42. ;
  43. ;where <X> is replaced with the number of a specfic group.
  44. ;NOTE: The value for the group can be not larger than the number of groups as 
  45. ;        defined in NumberOfGroups key in this section.
  46. ;
  47. ;The platform key must contain a value contained in the following set: 
  48. ;(All, Win32, Win16, Win95, WinNT, !WinNT).  
  49. ;All means this group is targeted to all Windows operating system. 
  50. ;Win32 means the target platform is Windows 95 or Windows NT.
  51. ;Win16 means the target platform is only 16 bit Windows (3.1x). 
  52. ;Win95 means only Windows 95.  
  53. ;WinNT means only Windows NT
  54. ;!WinNT means the target platform is All except Windows NT.
  55. ;
  56. ;Group<X>DestDir contains the target detination directory name.
  57. ;
  58. ;Group<X>Loc is the source location relative to the main installation directory
  59. ;(i.e. on the source media of the installation set, NOT where the user chose to
  60. ;install Acrobat).
  61. ;
  62. ;All remaining keys are used for performing certain actions.
  63.  
  64. ;Each group can then have entries for the five "object actions" and those actions
  65. ;use the group settings for determining the source, destination, etc.  Below is
  66. ;a description of how to set these up correctly.
  67. ;
  68. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  69. ;REQUIREMENTS
  70. ;
  71. ;To have a "requirement" performed, there must be one line in the group as follows:
  72. ;
  73. ;Group<X>NumberOfRequirements=<Y>, where <X> is the group number and <Y> is the 
  74. ;number of requirement actions to be performed for this group.  At this time, the
  75. ;only supported requirement is running the Windows application REGEDIT.EXE which
  76. ;can be used to add registry entries using a pre-defined registry file.
  77. ;
  78. ;The following shows an example requirement using REGEDIT:
  79. ;
  80. ;Group2NumberOfRequirements=1
  81. ;Group2Requirement1=REGEDIT
  82. ;Group2RegEditFile=Extra\Extra32.REG
  83. ;
  84. ;The key Group<X>RegEditFile=<.REG file> must exist on the users system in a
  85. ;sub-directory of the path where Acrobat was installed.  This .REG file will
  86. ;then be run via REGEDIT.EXE.
  87. ;
  88. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  89. ;FILE COPYING
  90. ;
  91. ;To have a file "blind copied" during installation, there must be a key named
  92. ;Group<X>NumberOfFiles, and the value of this key must be the number of files to 
  93. ;be copied from this source location to the group's target destination as defined 
  94. ;in the Group<X>DestDir and Group<X>Loc keys.
  95. ;
  96. ;For each file to be copied, a key of the following format must be defined:
  97. ;Group<X>FileName<Y>, where <X> is the group number and <Y> is the file number.
  98. ;NOTE: The file number cannot be greater than the number of files value.
  99. ;
  100. ;NOTE: There is no mechanism to rename files as they are copied.
  101. ;
  102. ;NOTE: Files will be directly copied.  The blind-copy mechanism would not know
  103. ;      which decompression scheme to use.
  104. ;
  105. ;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  106. ;PROGRAM ITEMS AND SHORTCUTS
  107. ;
  108. ;To create a program item or shortcut, a key must be defined containing the number
  109. ;of "icons" to be created.
  110. ;
  111. ;If the number is one or more, a key in the following format must be defined:
  112. ;Group<X>Icon<Y> (see notes above regrarding numbering).
  113. ;
  114. ;The value for these keys is rather cryptic, so please bear with this discussion.
  115. ;This type of object action requires a comma-delimited (i.e. separated by commas)
  116. ;value that has a variable number of parameters depending on the value of the first 
  117. ;parameter.
  118. ;
  119. ;The first parameter of the value must be either SYTLE1 or STYLE2.  
  120. ;STYLE1 is used when the object referred to is an executable or an automatically 
  121. ;launched file (i.e if the file's extension automatically launches the correct 
  122. ;executable).
  123. ;STYLE2 is used when the object referred to requires a primary executable to launch
  124. ;the second file (e.g. NOTEPAD.EXE is often used for launching a ReadMe file).
  125. ;
  126. ;Once the STYLE<X> is defined, the second portion refers to the working directory 
  127. ;for the file named in the third portion.  There are a limited number of values allowed
  128. ;for this second parameter.  If the first character is a '$' then the following values
  129. ;are accepted: Windows or WindowsSystem.  These refer to the directory where Windows is
  130. ;installed or the Windows System directory, respectively.
  131. ;
  132. ;As stated above, the third parameter is the name of the executable file (or automatically
  133. ;launched file is that is appropriate).
  134. ;
  135. ;The fourth parameter is the literal text that will be displayed in the Windows UI that
  136. ;describes the main file (for STYLE1 this is the file referred to in the 3rd parameter,
  137. ;for STYLE2 it is the file referred to in the 7th parameter).
  138. ;
  139. ;For the fifth parameter (and last for STYLE1 entries), this is a number for the index to
  140. ;the icon for Windows to use from the 3rd parameter.  This is typically 0 (zero).
  141. ;
  142. ;STYLE2 entries require two more parameters.  The sixth parameter is the location or
  143. ;working directory of the file referenced in the seventh and last parameter.
  144. ;
  145. ;The following explanation of the example entries should clarify most questions.
  146. ;
  147. ;Group1Icon1=STYLE1,Org,Match.exe,Match,0
  148. ;In this example, the above entry will create a program item or shortcut in the same 
  149. ;folder as was used by the Acrobat installation (because Group1Name is blank).  The item
  150. ;will display "Match" (the 4th parameter) as the description, and the command line created 
  151. ;will be for the program named Match.exe that is located in the Org directory below where 
  152. ;the user chose to put their Acrobat program files.  The first icon indexed within Match.exe 
  153. ;will be used in displaying the item.
  154. ;
  155. ;Group1Icon2=STYLE2,$Windows,Notepad.exe,Match ReadMe,0,Org,Readme.txt
  156. ;Here the entry will create a program item or shortcut in the same folder as was used by
  157. ;the Acrobat installation (because Group1Name is blank), for the file named Readme.txt
  158. ;that is located in the Org directory below where the user chose to put their Acrobat
  159. ;program files.  The description the user will see is "Match ReadMe" and the icon displayed
  160. ;will be the default icon for Notepad.exe.  The command line used to launch this item will
  161. ;be "<Windows drive and directory>\Notepad.exe <Drive and directory for Acrobat>\Org\Readme.txt"
  162. ;
  163. ;NOTE: Be careful when using Write.exe, because this file is located in    either the Windows
  164. ;        directory or the Windows System directory (on NT 4.0), thus making an entry that uses
  165. ;        Write.exe platform dependent.
  166. ;
  167. ;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  168. ;REGISTRY ENTRIES
  169. ;
  170. ;To create registry entries within a group, the first required line is:
  171. ;Group<X>NumberOfRegEntries=<Y>, where <X> is the number of the group and <Y> is the
  172. ;                                number of registry entries to add.
  173. ;
  174. ;For each registry entry, there must be a key with a comma-delimited value containing six parts.
  175. ;
  176. ;The first parameter is the target platform.  The platform defined at the group level may be broader
  177. ;than the registry entry, so there is another means of differentiating settings based on the
  178. ;operating system of the end-user.  The same values for platform are used for both the group and
  179. ;the registry entries (and, as you will see, for INI settings).
  180. ;
  181. ;The second parameter in the comma-delimited value is the parent class where the registry entry
  182. ;will be created.  The most commonly used values here are HKEY_CLASSES_ROOT (the only valid
  183. ;parent for 16 bit Windows), HKEY_LOCAL_MACHINE, and HKEY_CURRENT_USER.  These are the only
  184. ;values currently valid within the blind-copy mechanism.
  185. ;
  186. ;The third parameter is the subkey within the registry where the entry will be created.
  187. ;
  188. ;The fourth parameter is used for the "named value" portion of the registry key.  For 32 bit
  189. ;Windows platforms, keys may have multiple named values under one key.  For the 16 bit registry,
  190. ;there is no named value capability, thus all registry entries within a key are set to a default
  191. ;named value (as exemplified below in Group1RegEntry2 where the 4th parameter is "Default").
  192. ;
  193. ;The fifth parameter is used for setting the type of data to be stored in this registry key (or in
  194. ;the named value of that key).  The currently supported settings are STRING, MULTIPLE_STRING,
  195. ;EXPANDABLE_STRING, and NUMBER.  MULTIPLE_STRING is used when the string data has new lines embedded.
  196. ;EXPANDABLE_STRING is used when the string data contains an expandable environment variable such as
  197. ;"%PATH%".
  198. ;
  199. ;The sixth parameter is the literal value for the key or named value.
  200. ;
  201. ;Below are two examples of similar entries, one for the 32 bit registry and one for 16 bit registry.
  202. ;
  203. ;Group1RegEntry1=Win32,HKEY_LOCAL_MACHINE,Software\Adobe\Acrobat,BlindCopy,STRING,Match Utility
  204. ;Group1RegEntry2=Win16,HKEY_CLASSES_ROOT,Software\Adobe\Acrobat\BlindCopy,Default,STRING,Match Utility
  205. ;
  206. ;
  207. ;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  208. ;INI SETTINGS
  209. ;
  210. ;To create INI settings within a group, the first required line is:
  211. ;Group<X>NumberOfIniSettings=<Y>, where <X> is the number of the group and <Y> is the
  212. ;                                number of INI settings to add.
  213. ;
  214. ;For each INI setting, there must be a key with a comma-delimited value containing six parts.
  215. ;
  216. ;The first parameter is the target platform.  The platform defined at the group level may be broader
  217. ;than the INI setting, so there is another means of differentiating settings based on the
  218. ;operating system of the end-user.  The same values for platform are used for both the group and
  219. ;the INI settings.
  220. ;
  221. ;The second parameter in the comma-delimited value is the directory location of the INI file.  Again,
  222. ;$Windows and $WindowsSystem are valid settings as well as literal directories that are relative to
  223. ;where the Acrobat files were decompressed during installation.
  224. ;
  225. ;The third parameter is the INI file name.  If the file does not exist, it will be created.
  226. ;
  227. ;The fourth parameter is the section in the INI file where the setting will be made.  The section
  228. ;be created if it does not exist.
  229. ;
  230. ;The fifth parameter is the INI key within the section.
  231. ;
  232. ;The sixth parameter is the value for the key in the section.
  233. ;
  234. ;The following is a simple example that will create an entry in <Windows>\ArcoExch.ini under the
  235. ;section [BlindCopy] the following key:
  236. ;Match=Match.exe
  237. ;
  238. ;Group1IniSetting1=Win16,$Windows,AcroExch.ini,BlindCopy,Match,Match.exe
  239. ;
  240. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  241. ;
  242. ;At this time, this is the current functionality of the blind-copy mechanism that can be used
  243. ;with Adobe Acrobat installations.
  244. ;
  245. ;The following entries can be used as examples for the correct syntax for performing the various
  246. ;blind-copy actions.  These examples should not be used literally, unless by some miracle, your
  247. ;installation has these exact same files and settings.
  248. ;
  249. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  250.  
  251. [ReaderBlindCopy]
  252. NumberOfGroups=5
  253.  
  254. Group1Platform=All
  255. Group1DestDir=Org
  256. Group1Loc=Org
  257. Group1Name=
  258. Group1NumberOfFiles=3
  259. Group1FileName1=Match.exe
  260. Group1FileName2=Match.hlp
  261. Group1FileName3=ReadMe.txt
  262. Group1NumberOfIcons=2
  263. Group1Icon1=STYLE1,Org,Match.exe,Match,0
  264. Group1Icon2=STYLE2,$Windows,Notepad.exe,Match ReadMe,0,Org,Readme.txt
  265. Group1NumberOfRegEntries=2
  266. Group1RegEntry1=Win32,HKEY_LOCAL_MACHINE,Software\Adobe\Acrobat,BlindCopy,STRING,Match Utility
  267. Group1RegEntry2=Win16,HKEY_CLASSES_ROOT,Software\Adobe\Acrobat\BlindCopy,Default,STRING,Match Utility
  268. Group1NumberOfIniSettings=1
  269. Group1IniSetting1=Win16,$Windows,AcroExch.ini,BlindCopy,Match,Match.exe
  270.  
  271. Group2Platform=Win32
  272. Group2DestDir=
  273. Group2Loc=Extra
  274. Group2Name=
  275. Group2NumberOfRequirements=0
  276. Group2NumberOfFiles=1
  277. Group2FileName1=Extra32.REG
  278. Group2NumberOfIcons=0
  279. Group2NumberOfRegEntries=0
  280. Group2NumberOfIniSettings=0
  281.  
  282. Group3Platform=Win32
  283. Group3DestDir=
  284. Group3Loc=
  285. Group3Name=
  286. Group3NumberOfRequirements=1
  287. Group3Requirement1=REGEDIT
  288. Group3RegEditFile=Extra\Extra32.REG
  289. Group3NumberOfFiles=0
  290. Group3NumberOfIcons=0
  291. Group3NumberOfRegEntries=0
  292. Group3NumberOfIniSettings=0
  293.  
  294. Group4Platform=Win16
  295. Group4DestDir=
  296. Group4Loc=Extra
  297. Group4Name=
  298. Group4NumberOfRequirements=0
  299. Group4NumberOfFiles=1
  300. Group4FileName1=Extra16.REG
  301. Group4NumberOfIcons=0
  302. Group4NumberOfRegEntries=0
  303. Group4NumberOfIniSettings=0
  304.  
  305. Group5Platform=Win16
  306. Group5DestDir=
  307. Group5Loc=
  308. Group5Name=
  309. Group5NumberOfRequirements=1
  310. Group5Requirement1=REGEDIT
  311. Group5RegEditFile=Extra\Extra16.REG
  312. Group5NumberOfFiles=0
  313. Group5NumberOfIcons=0
  314. Group5NumberOfRegEntries=0
  315. Group5NumberOfIniSettings=0
  316.  
  317.